home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / utilities / sourcopt.lha / SourcOpt / SOURCOPT.DOC < prev    next >
Encoding:
Text File  |  1992-12-05  |  3.2 KB  |  69 lines
  1.  
  2.                         SELCO Source Optimizer 1.0
  3.                        ----------------------------
  4.  
  5. Note: Source Optimizer 1.0 is public domain.
  6.       No changes, no commercial use and no distribution for more than DM 5.-
  7.       
  8.       Any distribution must contain the English and German documentation and
  9.       the executable source optimizer.
  10.  
  11. The SELCO Source Optimizer is a little utility for optimizing assembly files.
  12. Well, the most assemblers have an optimizer function included, but in my
  13. opinion there is one important disadvantage by these assemblers. If you, the
  14. programmer are debugging a self written assembly program by stepping in a
  15. disassembler or monitor, the code you see differs from that you have written 
  16. before because of the (automaticly) optimizer function of your assembler. Thats
  17. why I decide to write the source optimizer to optimize the source files, not
  18. the executables. In this way the programmer get a short and fast code witch
  19. differs not so much from his source.
  20.  
  21. How to use SELCO Source Optimizer 1.0
  22.  
  23. You must run the source optimizer from CLI or SHELL. For getting a help message
  24. simply type 'sourcopt'.
  25. The syntax is like following:    'sourcopt InputFile OutputFile / Flags'
  26. Between all parts of the command line there must be one or more spaces.
  27. The name of the outputfile must differ from that of the inputfile. There must
  28. be one or more flags separated by space characters.
  29. valid flags are:
  30. a - change  move.l #x,Dn      -> moveq #x,Dn if x 0...127 (x dec bin or hex)
  31. b - change  move.l #Label,An  -> lea Label(pc),An
  32. c - change  move.l Label,...  -> move.l Label(pc),...
  33. d - change  move.l #0,An      -> suba.l An,An             (0 dec bin or hex)
  34.  
  35. In case of a mistake in the command line a help message is shown.
  36.  
  37. How SELCO Source Optimizer 1.0 works
  38.  
  39. The source optimizer first looks for all labels in the source text. In this way
  40. the source optimizer can decide between labels and constants. A label is a text
  41. starting in the first column not followed by '=', 'equ' or 'macro'. A comment
  42. will not processed of course. A comment is a line or a part of a line starting
  43. with a ';' or a '*'.
  44. In a changed line the old command will be replaced by the new command. Labels,
  45. comments and constants of this line will not be changed of course.
  46. While working source optimizer will display the processed line and the number
  47. of labels found in pass 1 and the processed line, the number of changed lines
  48. and the number of spared bytes in pass 2.
  49.  
  50. Note: Source optimizer does not check for syntax errors, that means, for proper
  51.       working the source text should not contain syntax errors. (Simply make a
  52.       syntax test by assembling the source file with your assembler.)
  53.  
  54. Please send suggestions, bug reports etc. to
  55.  
  56.                               SELCO
  57.                               Alexander Fritsch
  58.                               Hafenstr. 20
  59.                               O-2355 Sassnitz/Rg.
  60.                               Germany   
  61.  
  62. P.S.  SELCO Source Optimizer 1.0 was compiled with M. Dillons DICE compiler.
  63.       (Demo version) I hope to get the registred version of these great program
  64.       in the next weeks. Thanks to M. Dillon for writing DICE.
  65.  
  66.                                           Sassnitz, 9.11.92   A. Fritsch
  67.  
  68.  
  69.